Help FreeCAD/pt

Introdução

Se gosta do FreeCAD e gostaria de ajudar este projecto, há muitas coisas que pode fazer, não importa se prefere contribuir com tempo, dinheiro, ou se sabe ou não programar.

Doações em dinheiro

Embora o FreeCAD não precise de dinheiro para continuar a ser desenvolvido, as doações ajudam o projecto a crescer mais rápido e mais longe. A página de Doações lista todas as opções que tem para poder doar dinheiro para o projecto.

Trabalhar na documentação

Ajude-nos a construir, corrigir e ampliar esta documentação. Corrigir erros, ampliar ou corrigir páginas que não estejam claras, criar novas páginas se faltar um tópico, etc. Contribuir para o wiki do FreeCAD é fácil, em PaginasWiki você pode encontrar as diretrizes gerais e a ajuda necessária para começar. Para editar o wiki, você precisará de uma conta wiki com permissões de "Editor" (o wiki é protegido contra gravação para evitar ‘spam’). Pode solicitar uma conta fórum ou no IRC. Note que o canal do IRC pode não ser tão imediato a responder como o fórum. O fórum oficial do FreeCAD deve ser o local principal para fazer perguntas e iniciar debates, pois ajudará a preservar a experiência e o conhecimento da comunidade.

Algumas áreas que beneficiam com o seu trabalho:

• A página Category:Command Reference lista e documenta todos os commands FreeCAD. A maioria deles contém pouca ou até nenhuma informação no momento. Por favor consulte as WikiPages ver bons exemplos sobre como as páginas de documentação de comandos devem ser.
• A secção de Tutoriais precisa de exemplos sobre como utilizar as bancadas de trabalho. Se desenvolveu algo interessante com o FreeCAD, porque não documentar como o fez para a posteridade?
• Existem tickets abertos no FreeCAD "bug tracker" marcados como "documentation" que precisam de algum amor.

Partilhe o seu conhecimento do FreeCAD

A comunidade de utilizadores em torno do FreeCAD ainda é pequena, mas já inclui vários utilizadores experientes que fazem um trabalho muito importante a mostrar aos recém-chegados como utilizar o ‘software’. Se começar a sentir-se confortável com o FreeCAD, os seus conhecimentos poderão ser muito valiosos para outros, e poderá contribuir com recursos importantes como, por exemplo:

• Mostrando o trabalho que fez com o FreeCAD no fórum 'Users Showcase forum'. Pode colocar capturas de ecrã e melhor ainda se anexar os arquivos do FreeCAD, para que outras pessoas possam examiná-lo e compreender como foi feito.
• Gravar vídeos mostrando como fez algo interessante no FreeCAD. Estes vídeos fazem normalmente um excelente trabalho mostrando novas funcionalidades.
• Escrever tutoriais descrevendo ou ensinando algo interessante. Pode escrever tutoriais no seu próprio "blog", diretamente no nosso wiki, ou mesmo no fórum.
• Publique na rede social de código aberto Mastodon (e siga o FreeCAD lá) ou na comunidade do Facebook.
• Veja os últimos posts FreeCAD no Reddit, 3dprinting.stackexchange, StackOverflow... Tente responder e participe das discussões partilhando a sua experiência e informação.
• Participar do canal IRC FreeCAD ou outras salas de conversa.

Traduzir o FreeCAD

Traduza o FreeCAD para o seu idioma. Todas as 'strings' de texto do interface FreeCAD podem ser facilmente traduzidas para outros idiomas. Tudo o que é preciso é alguém que saiba esses outro idioma e alguma vontade em ajudar! Todas as traduções são feitas online em Crowdin.

Para mais detalhes sobre traduções, consulte Tradução.

Traduzir a documentação

Traduzir é fácil, o FreeCAD wiki auxilia com um plugin que permite que traduza do Inglês base para outros idiomas.

Para mais detalhes sobre tradução, consulte Localisation#Traduzindo o wiki.

Por favor, certifique-se de que está familiarizado com os fundamentos de marcação wiki; ver Ajuda:Editando como referência.

Depois dirija-se a WikiPages para se familiarizar com o estilo usado neste wiki, principalmente quando se trata de modelos.

Ajudar os outros a conhecer o FreeCAD

• Fale sobre o FreeCAD a outras pessoas que possam ter interesse.
• Se encontrar usos interessantes para o FreeCAD, documente-os, usando capturas de ecrã como exemplo. O FreeCAD é bastante jovem, e muitas pessoas não imaginam o que se pode fazer com ele. Se já é um fã do FreeCAD, certamente sabe algo interessante que o FreeCAD pode fazer. Ajude-nos a mostrar isso a outros!
• Passe pelo fórum e ajude os recém-chegados a resolver questões básicas.
• Escreva tutoriais, grave vídeos, etc., mostrando o que pode fazer com o FreeCAD.
• Contribua com ficheiros, desenhos, etc. Ainda faltam bons ficheiros de exemplo do que pode ser feito com o FreeCAD.
• Ajude a promover o FreeCAD no GitHub dando uma "Estrela" e "Observando" o repositório FreeCAD

Reportar falhas e solicitar funcionalidades interessantes

Embora o local adequado para relatar erros confirmados e sugerir novas funcionalidades seja, eventualmente, o FreeCAD Issue Tracker on GitHub,por favor publique sempre primeiro os relatórios de erros e pedidos de funcionalidades no fórum de Ajuda. Para poupar tempo aos desenvolvedores (triagem e tratamento de erros difíceis de entender pode ser muito demorado) e evitar frustrações porque o seu problema não foi tratado da forma como gostaria, por favor leia o seguinte:

• Erros e pedidos de funcionalidades são tratados no mesmo sistema de rastreio. Basta marcar o seu item como "bug" (algo que não funciona como deveria) ou "feature" (algo que não existe mas que acha que seria bom ter).
• Embora originalmente fosse possível submeter problemas anonimamente, infelizmente isso teve de ser cancelado devido a spam. Agora, se deseja criar/editar tickets, terá de criar uma conta. Será então notificado por defeito quando alguém adicionar notas ao item. Em muitos casos, a pessoa que tratará do erro precisará de mais informações suas.
• Ao relatar um erro, o ponto mais importante é permitir que os desenvolvedores o reproduzam. Certifique-se de incluir os passos exatos necessários para que o erro aconteça, para que outra pessoa possa fazer o mesmo e ver o erro acontecer na sua máquina também. Se o desenvolvedor não puder ver o erro, também não poderá resolvê-lo.
• Inclua também informações que ajudem os desenvolvedores a situar o problema, como o sistema operativo em que está a executar o FreeCAD, a versão exata do FreeCAD e as bibliotecas relevantes. Por favor publique todos os dados usando o botão "copy to clip board" no diálogo Ajuda (menu) → Sobre o FreeCAD.
• Independentemente de quão certo esteja de que encontrou um erro, por favor discuta-os sempre primeiro no Help forum.
• Antes de submeter um pedido de funcionalidade, discuta-o sempre primeiro com outros utilizadores no Open discussion forum, para que possa acabar com uma proposta mais sólida, com mais hipóteses de interessar um desenvolvedor a implementá-la.
• Lembre-se de que o FreeCAD é desenvolvido por voluntários que utilizam o seu tempo livre para trabalhar nele. Embora todos tentem dar o seu melhor para criar a melhor aplicação possível, o seu relatório de erro pode ser tratado com baixa prioridade ou cancelado se não puder fornecer informação suficiente, e o seu pedido de funcionalidade pode ser adiado ou até recusado se nenhum desenvolvedor tiver interesse em implementá-lo ou se isso exigir uma quantidade irrealista de trabalho.

Triagem de erros

Há dezenas de erros reportados em GitHub semanalmente. É preciso muito tempo para os ler, categorizá-los, verificar se o problema pode ser reproduzido, ver se com alguns passos pode reproduzir o problema, ou pedir à pessoa que reportou o problema para disponibilizar mais informação. Ajudando com a triagem é fácil, vá até a GitHub e coloque os seus comentários em qualquer situação que veja que pode ajudar a resolver!

Projeto artístico

Veja as páginas Objectos gráficos e Diretrizes para trabalhos gráficos orientações sobre a criação de icons para o FreeCAD.

Escreva código

Escrever código para o FreeCAD não é difícil, e não precisa de qualquer permissão — pode começar já a trabalhar em algo que deseja, depois submeter um 'patch' no issue tracker ou pedir um 'merge' a partir de um git branch. Para evitar dores de cabeça, deve primeiro cumprir os seguintes pré-requisitos:

• Informação sobre como compilar o FreeCAD está disponível para diferentes sistemas operativos.
• Antes de começar a programar para o FreeCAD, deve saber como o FreeCAD funciona. Isto parece óbvio, mas se não souber como é suposto funcionar, não saberá o que fazer internamente ou como fazê-lo.
• Quase tudo pode ser feito em Python ou C++. Os internos funcionam praticamente da mesma forma em ambas as linguagens. Sugerimos que leia as páginas do Power users hub, mesmo que vá programar em C++, pois dar-lhe-á uma boa visão geral do funcionamento interno.
• Se vai trabalhar em C++, certifique-se primeiro de que consegue compilar o FreeCAD sem problemas.
• Apresente-se aos outros desenvolvedores. O FreeCAD é antes de mais um projeto social — discutimos muitas coisas no fórum antes de as implementar, e é sempre melhor discutir as suas ideias e dizer às pessoas o que planeia fazer antes de realmente o fazer. Também temos um canal IRC que está sincronizado com o nosso canal Matrix, bem como um canal Discord.
• Desde 2016, o FreeCAD também participa no Google Summer of Code 2020. Certifique-se de verificar lá as nossas ideias caso esteja interessado em participar na próxima edição.
• Cada vez mais funcionalidades do FreeCAD não são escritas no próprio código do FreeCAD, mas sim em addons, macros e extensões. Em conjunto, este ecossistema é o que torna o FreeCAD poderoso. Muitas vezes, trabalhar num addon é mais fácil porque há menos código para ler e compreender, e menos pessoas envolvidas. Veja o repositório de Addons e o repositório de Macros para obter algumas ideias!

Criar modelos

O FreeCAD inclui uma Models library que é livre e aberta a todos. Porque não adicionar lá algumas peças úteis, que possam ser reutilizadas por outros? Certifique-se de criar os modelos você mesmo, do zero, para manter a biblioteca 100% livre de componentes possivelmente protegidos por direitos de autor ou não livres.